home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat5 / libirixpmda.z / libirixpmda
Encoding:
Text File  |  2001-04-17  |  11.5 KB  |  265 lines
  1.  
  2.  
  3.  
  4. LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))                                                  LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa - performance metrics domain agent for IRIX
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa is a Performance Metrics Domain Agent (PMDA) for the
  13.      Performance Co-Pilot (see PPPPCCCCPPPPIIIInnnnttttrrrroooo(1)) which uses system calls to obtain
  14.      performance metrics from the IRIX kernel.  lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa is loaded by
  15.      ppppmmmmccccdddd(1) as a Dynamically Shared Object (DSO) when ppppmmmmccccdddd(1) is started.
  16.  
  17.      lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa exports metrics from many kernel subsystems, including:
  18.  
  19.      ddddiiiisssskkkk          Disks and disk controllers
  20.  
  21.      ffffiiiilllleeeessssyyyyssss       Filesystem usage
  22.  
  23.      hhhhiiiinnnnvvvv          System configuration
  24.  
  25.      hhhhuuuubbbb           Origin hub error counts
  26.  
  27.      hhhhwwww            R10K and Origin router hardware counters
  28.  
  29.      iiiippppcccc           Inter-process communication protocols
  30.  
  31.      kkkkaaaaiiiioooo          Kernel asynchronous I/O
  32.  
  33.      kkkkeeeerrrrnnnneeeellll        CPU and system call activity
  34.  
  35.      mmmmeeeemmmm           Physical and virtual memory usage
  36.  
  37.      nnnneeeettttwwwwoooorrrrkkkk       Network interface utilization
  38.  
  39.      nnnnffffssss           NFS utilization
  40.  
  41.      nnnnooooddddeeee          Origin node memory usage
  42.  
  43.      nnnnuuuummmmaaaa          Origin page migration activity
  44.  
  45.      rrrreeeessssoooouuuurrrrcccceeee      Kernel resources
  46.  
  47.      rrrrppppcccc           RPC client/server activity
  48.  
  49.      sssswwwwaaaapppp          Memory swap activity
  50.  
  51.      xxxxbbbboooowwww          Origin xbow I/O throughput
  52.  
  53.      xxxxffffssss           XFS file system activity
  54.  
  55.      xxxxllllvvvv           XLV volume activity
  56.  
  57.      The entire list of metrics exported by lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa can be obtained with
  58.      the ppppmmmmiiiinnnnffffoooo(1) command:
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))                                                  LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))
  71.  
  72.  
  73.  
  74.                > pminfo irix hinv hw
  75.  
  76.      All metrics collected by lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa have a help text entry that can be
  77.      displayed with:
  78.  
  79.                > pminfo -T irix.kernel.all.cpu.user
  80.  
  81.      The set of metrics that are available will vary between each IRIX release
  82.      and hardware platform.
  83.  
  84. EEEENNNNAAAABBBBLLLLIIIINNNNGGGG OOOOFFFF SSSSTTTTAAAATTTTIIIISSSSTTTTIIIICCCCSSSS CCCCOOOOLLLLLLLLEEEECCCCTTTTIIIIOOOONNNN
  85.      Several kernel subsystems (or clusters of metrics) must have their
  86.      statistics gathering explicitly enabled. In the cases where the
  87.      collection process is expensive, we require that the user manually enable
  88.      the collection process, in other cases lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa will automatically
  89.      enable it.
  90.  
  91.      Manually enabled metrics include the R10k event counters (hw.r10kevctr)
  92.      and the Crossbow metrics (irix.xbow).  The automatically enabled metrics
  93.      include the xlv metrics (irix.xlv).  To activate the system-level
  94.      processor event counters (hw.r10kevctr) you must run eeeeccccaaaaddddmmmmiiiinnnn(1) as root,
  95.      e.g.
  96.  
  97.           _eeee_cccc_aaaa_dddd_mmmm_iiii_nnnn _----_aaaa
  98.  
  99.      would enable all of the processor event counters.  To activate the
  100.      Crossbow metrics (irix.xbow) see the section below on storing to
  101.      irix.xbow.switch.
  102.  
  103.      The xlv metrics are enabled at startup if the xlv statistics gathering is
  104.      found to have been turned off. The xlv statistics can be manually turned
  105.      off via
  106.  
  107.           _xxxx_llll_vvvv______mmmm_gggg_rrrr _----_RRRR_xxxx_cccc _""""_cccc_hhhh_aaaa_nnnn_gggg_eeee _ssss_tttt_aaaa_tttt _oooo_ffff_ffff_""""
  108.  
  109.      and manually turned on via
  110.  
  111.           _xxxx_llll_vvvv______mmmm_gggg_rrrr _----_RRRR_xxxx_cccc _""""_cccc_hhhh_aaaa_nnnn_gggg_eeee _ssss_tttt_aaaa_tttt _oooo_nnnn_""""
  112.  
  113.      If the statistics are manually turned off then when libirixpmda next
  114.      detects this, it will write out a warning message to the log,
  115.      ////vvvvaaaarrrr////aaaaddddmmmm////ppppccccpppplllloooogggg////ppppmmmmccccdddd....lllloooogggg.  If the statistics are subsequently turned back
  116.      on, then this fact will also be logged when libirixpmda next detects it.
  117.      Note, however, libirixpmda will only ever turn on the xlv statistics at
  118.      startup or whenever libirixpmda is reset.
  119.  
  120. SSSSTTTTOOOORRRRAAAABBBBLLLLEEEE MMMMEEEETTTTRRRRIIIICCCCSSSS
  121.      Several metrics may be altered using the ppppmmmmssssttttoooorrrreeee(1) command to change the
  122.      behavior of lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa.  These metrics are:
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))                                                  LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))
  137.  
  138.  
  139.  
  140.      _i_r_i_x._p_m_d_a._r_e_s_e_t
  141.          Reset the entire lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa causing every cluster to reinitialize
  142.          and probe the system configuration from scratch.  If the system
  143.          configuration has changed in a way that lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa cannot easily
  144.          detect and/or handle, such as adding or removing disks with ssssccccssssiiiihhhhaaaa(1)
  145.          or ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp(1), a value should be stored into this metric:
  146.  
  147.                > pmstore irix.pmda.reset 1
  148.  
  149.      _i_r_i_x._p_m_d_a._d_e_b_u_g
  150.          By default, only error messages are dumped by lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa to the
  151.          ppppmmmmccccdddd(1) log file.  Additional output can be generated by storing any
  152.          combination of these flags into _i_r_i_x._p_m_d_a._d_e_b_u_g:
  153.  
  154.          1111      General
  155.  
  156.          2222      Instance domains
  157.  
  158.          4444      CPU metrics
  159.  
  160.          8888      Disk metrics
  161.  
  162.          11116666     Node metrics
  163.  
  164.          33332222     Fetch from ppppmmmmccccdddd(1)
  165.  
  166.          66664444     High precision counters
  167.  
  168.          111122228888    Xbow metrics
  169.  
  170.          222255556666    XLV volumes
  171.  
  172.          555511112222    Mounted EFS and XFS file systems
  173.  
  174.          1111000022224444   Network interfaces
  175.  
  176.          2222000044448888   Memory Audit
  177.  
  178.      _i_r_i_x._x_b_o_w._s_w_i_t_c_h
  179.          By default, the _i_r_i_x._x_b_o_w metrics are turned off as they can affect
  180.          the performance of the XBow hardware on Origin systems.  To turn all
  181.          XBow metrics on, run the command:
  182.  
  183.                > pmstore irix.xbow.switch 1
  184.  
  185.          while storing 0 will turn all Xbow monitoring off.  Individual XBows
  186.          can turned on and off by specifying the XBow instances.  For example,
  187.          to monitor only the first two XBows on an Origin system, you may do
  188.          these commands:
  189.  
  190.                > pmstore irix.xbow.switch 0
  191.                > pmstore -i"xbow0,xbow1" irix.xbow.switch 1
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))                                                  LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))
  203.  
  204.  
  205.  
  206.          Every time a Xbow is stopped or started, the _i_r_i_x._x_b_o_w._g_e_n generation
  207.          number will increment.  This can be used by specialized clients
  208.          receiving these metrics to detect the re-initialization of the XBow
  209.          counters so that bogus values are not used.
  210.  
  211.          XBows may also be monitored by xxxxbbbbssssttttaaaatttt(1).  Only one of xxxxbbbbssssttttaaaatttt(1) and
  212.          lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa may monitor the same XBow at the same time.
  213.  
  214. FFFFIIIILLLLEEEESSSS
  215.      /_u_s_r/_p_c_p/_l_i_b/_m_i_p_s_AAAABBBBIIII._l_i_b_i_r_i_x_p_m_d_a._s_o
  216.           The location of lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa where AAAABBBBIIII may be either o32, n32 or 64
  217.           depending on the running kernel.
  218.  
  219.      /_v_a_r/_p_c_p/_p_m_d_a_s/_i_r_i_x
  220.           The location of the lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa help text.
  221.  
  222.      /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t__i_r_i_x
  223.           the Performance Metrics Namespace (PMNS) for lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa.
  224.  
  225.      /_v_a_r/_a_d_m/_p_c_p_l_o_g/_p_m_c_d._l_o_g
  226.           The default location of the ppppmmmmccccdddd(1) log file.
  227.  
  228. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  229.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmccccdddd(1), ppppmmmmiiiinnnnffffoooo(1), ppppmmmmssssttttoooorrrreeee(1), ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp(1), ssssccccssssiiiihhhhaaaa(1)
  230.      and xxxxbbbbssssttttaaaatttt(1).
  231.  
  232. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  233.      All diagnostics are reported in the ppppmmmmccccdddd(1) log file,
  234.      /_v_a_r/_a_d_m/_p_c_p_l_o_g/_p_m_c_d._l_o_g.  The verbosity of output may be controlled by
  235.      storing appropriate flags into _i_r_i_x._p_m_d_a._d_e_b_u_g.
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.